home *** CD-ROM | disk | FTP | other *** search
/ MACD 5 / MACD 5.bin / workbench / boot / czesc_1 / bootselector1.24 / english / bootselector.doc next >
Text File  |  1995-10-23  |  18KB  |  423 lines
  1. BootSelector1.23-DOC by Michael Gollmick
  2.  
  3.   --  -- - --  -- - --  -- - --  -- - --  -- - --  -- - --  -- - --  --
  4.    ________
  5.   \   ___  \  ° _°_     ____  ____           _______      _______
  6.    \  \  \__\   \  \   / _ / / _ /______    / _____/     /_  _  /___
  7.     \  \     ___ \ \\ /  //_/  //_   __/   / /_________ //  //_//  /__
  8.      \  \ ___\  \ \  X   / _\  / _\  _)_  /____  /  _  X   /_/_   ___/
  9.       \  \\___\  \/  /  /  // /  // /   \ _   / /  (_)  ) ___//  /
  10.        \  \___\\____/  /   / /   /_______\/__/ / \     / /   /  /
  11.         \________\/_______/_____/      /______/   \___/ /   /__/
  12.                                                     /__/   
  13.  
  14.     - --  -- - --  -- - --  -- - --  -- - --  -- - --  -- - --  -- -
  15.  
  16.  
  17.                   presents
  18.  
  19.                   BootSelector 1.24
  20.                   =================
  21.  
  22.              © 1995 by Michael Gollmick
  23.  
  24.     I    Distribution               This is MAILWARE
  25.     II   Warranty                   No warranty!
  26.     III  Requirements               68060, 32MB RAM, Gfx-Board? No!
  27.     IV   Introduction               Something about the program
  28.     V    Usage and Installation     How to use a program
  29.     VI   BUGS                       No BUGS in this version, sorry
  30.     VII  The Future                 What future developing will bring
  31.     VIII Credits                    People who helped me
  32.     IX   History                    The most boring part...
  33.     X    Support                    Hotline for free...
  34.  
  35. Distribution
  36. ------------
  37.  
  38. BootSelector is freely distributable Software. The archive must not be modified
  39. and  must  be  spread as a whole. BBSes may add their sign to the archive. This
  40. program is not Public Domain. It is FREEWARE. Thats why I haven't included  the
  41. sources. This program is also MAILWARE. That means, I expect a mail or a letter
  42. from everyone, who is using it. This mail should contain some information about
  43. the  particular  machine being used and the user. Your information will help me
  44. TO remove BUGs quicker.
  45. Personal information is kept confidential and is only for me.
  46. This archive may be included in every PD-Library, BUT under the  observance  of
  47. the  conditions  named,  and  also  of  mailing or writing to me as the author.
  48. Excluded   from   these   conditions   are   only   the   Aminet-    and    the
  49. Fred-Fish-Collections.  If  you  mail  me  (and  this  is the proper meaning of
  50. MAILWARE), please use the following sheet:
  51.  
  52. -------------------------------------------------------------------------------
  53.  
  54. Name, Firstname:
  55. E-Mail         :
  56. Country, City  :
  57. Computer       :
  58. Kickstart      :
  59. Processor      :
  60. Memory         :
  61. Comment        :
  62.  
  63. -------------------------------------------------------------------------------
  64.  
  65. Warranty
  66. --------
  67.  
  68. There is no warranty implied with this software.  Please read the following:
  69.  
  70. THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE
  71. LAW.  EXCEPT  WHEN  OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDER AND/OR
  72. OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT  WARRANTY  OF  ANY  KIND,
  73. EITHER  EXPRESSED  OR  IMPLIED,  INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  74. WARRANTIES OF MERCHANTABILITY AND FITNESS FOR  A  PARTICULAR  PURPOSE.  THE
  75. ENTIRE  RISK  AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.
  76. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST  OF  ALL  NECESSARY
  77. SERVICING, REPAIR OR CORRECTION.
  78. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING  WILL
  79. ANY  COPYRIGHT  HOLDER, OR ANY OTHER PARTY WHO MAY REDISTRIBUTE THE PROGRAM
  80. AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,  INCLUDING  ANY  GENERAL,
  81. SPECIAL,  INCIDENTAL  OR  CONSEQUENTIAL  DAMAGES  ARISING OUT OF THE USE OR
  82. INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA  OR
  83. DATA  BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES
  84. OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER  PROGRAMS),  EVEN  IF
  85. SUCH  HOLDER  OR  OTHER  PARTY  HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
  86. DAMAGES.
  87.  
  88. Requirements
  89. ------------
  90.  
  91. I don't know what your local PC-Dealer is recommending (but  most  likely  he's
  92. trying  to  sell  only  overbeared, wrong calculating 5umms or a "really great,
  93. favourable,  powerful"  80268  and  conceals,  that  PC's   where   technically
  94. overhauled already in 1989)
  95. We against recommend FOR this really useful program:
  96.  
  97.  - Amiga 500, 500+, 600, 1000, 1200, 2000, 3000, 4000; DraCo
  98.  - Kickstart 2.0 or higher
  99.  - Harddisk (recommended!)
  100.     because selecting the `Startup-Sequence` in Floppy-Disks-Only-Mode is a
  101.     little bit senseless, nevertheless the program will work.
  102.  - a mouse of course
  103.  - `Execute`-command
  104.  
  105. Are you familiar with the problem? You invested Money in a better Monitor  (VGA
  106. or  Multi-sync)  and the mode you use is not the 15 Khz default Screenmode? But
  107. when booting, your Amiga is in it's in native Screenmode of 15kHz?  Imaginative
  108. as  we Amiga-purists are, we write some '>NIL:'s to the Startup-Sequence and we
  109. are no longer in the 15kHz-Screen. On  Relais  Monitors  switching  into  other
  110. frequencies  occurs with a loud click when IPrefs is started. The screen is now
  111. opened in its higher frequency and your machine is ready  to  work.  Since  the
  112. Amiga  is  an  open ended machine with unlimited methods of configuration, many
  113. users configure their machines using different script files (as I sometimes  do
  114. myself)  and  execute  these  script  files using a program such as BootManager
  115. (from Daniel Bachmann). And are subject again  to  the  lousy  old  Problem  of
  116. clicking relais. All this 'choosing-programs' has had the same problem: We open
  117. a 15kHz-Screen, choose our script, let click the relais and switch the mode  to
  118. Super-Hires-256 NonInterlace.
  119.  
  120. IF not FOR the lousey 15 Khz DEFAULT screen I would be using BootManager today.
  121. But  of  course  the BootManager is used by me even today, if there wouldn't be
  122. this lousy 15-kHz-Screen! Now ask your physician or druggist and he wouln't  be
  123. able  to  help you, he is already happy, if he is able to run his cash-software
  124. on his PC and in no case he can spent any time in a 'lousy' Amiga (I also think
  125. 99.9%  of  all  physicians  and  druggists  have  no  idea of the Amiga). So we
  126. continue searching some solution.
  127.  
  128. After spending countless hours searching for a program  to  solve  the  15  Khz
  129. dilemma,  I decided to come up with a solution of my own, knowing others in the
  130. Amiga community would benefit from my efforts.
  131.  
  132. After numerous attempts, I had a version which was able to execute a script  if
  133. a  mousebutton was pressed at start up. I decided to expand this feature for my
  134. brand new 3 Button-Mouse. So it was finally possible  to  execute  6  different
  135. scripts  with a 3-Button-Mouse or 3 different scripts with a 2-Button-Mouse. On
  136. my machine, BootSelector is now running with only 3 Startup-Sequences  (because
  137. I don't need more).
  138. It looks as follows:
  139.  
  140. IF you don't press any  mousebutton  at  startup,  the  machine  will  boot  in
  141. ordinary  fashion with no opened screen, AND the standard-Startup-Sequence will
  142. be loaded.
  143.  
  144. IF you press the middle mousebutton, BootManager will be loaded.
  145.  
  146. IF you press the left mousebutton at startup, my favourite game will be loaded.
  147.  
  148. I havn't put a Startup-Sequence onto the other mousebuttons,  because  I  don't
  149. need  more  at  the moment. But the potential is there. You can use the RMB and
  150. combinations of the mousebuttons, for a total of six different  scripts,  since
  151. LMB+RMB  and  LMB+RMB+MMB  are used by systems early startup (Startup-Menu). In
  152. the future there will be a solution for using these combinations too.
  153.  
  154. Introduction
  155. ------------
  156.  
  157. The useage + installation
  158. -------------------------
  159.  
  160. The best way to install this package is to use the  included  Installer-Script.
  161. Please  confirm  (through  the  CBM  version  command)  that  you are using the
  162. Commodore Installer Version 1.24 or higher, since there will  be  some  obvious
  163. malfunctions if you use a lower version.
  164.  
  165. When the Installation is  complete,  you  should  configure  your  existing  or
  166. alternative  scripts  thru  BootSelector.  For  doing  this,  you should do the
  167. following:
  168. - open the Startup-Sequence from S: for editing.
  169. - add a  keyword  after the command BootSelector in  the  first  execution-line
  170.   (e.g.  LMB),  than  a  '=' followed by the name of the alternative script. It
  171.   could look as folows:
  172.   BootSelector LMB=Galaga.STARTUP
  173. - additionally  there  should  be  a  path  FOR  the  alternate  scripts  since
  174.   BootSelector  searches  the  S:  path by default. But if you are working with
  175.   many Startup-Sequences  it  is  recommended  you  put  them  into  their  own
  176.   directory  (as  done by the Installer; e.g. S:Startup's). This information is
  177.   done by the keyword DIR or SCRIPTDIR. It looks as follows:
  178.     BootSelector SCRIPDIR=S:Startup's/
  179.   It is imperative  the  ending  '/'  (backslash)  or  ':'  is  present,  since
  180.   BootSelector  does  not  automatically append it and will fail if this is not
  181.   included.
  182. - At the end the line should look nearly this:
  183.     BootSelector LMB=Alternate.Startup MMB=Galaga.Startup DIR=S:Startup's/
  184.  
  185. - The single Keywords(ToolTypes) may be shown by the command  'BootSelector  ?'
  186.   Here the descriptions:
  187.    REGULAR=REG   IF you press no mousebutton
  188.    LMB           IF you press left mousebutton
  189.    MMB           IF you press middle mousebutton
  190.    RMB           IF you press right mousebutton
  191.    LMM           IF you press left AND middle mousebutton
  192.    RMM           IF you press right AND middle mousebutton
  193.    SCRPTDIR=DIR  Path FOR ALL the Scripts
  194.  
  195. The Installer-Script does copy some alternative scripts to  S:Startup's,  which
  196. have  the  same  names  as the defaults in BootSelector. So you can also rename
  197. your alternative scripts to these names or edit the include scripts. If you  do
  198. this, there is no need to edit the keywords after the command BootSelector.
  199. With the command 'version Startup-SequenceXXX' you can learn  which  script  is
  200. for  which  mousebutton, where XXX stands for the roman numerals after the word
  201. Startup-Sequence.
  202.  
  203. BUGS
  204. ----
  205.  
  206. This program has been tested on my machine most extensively (in  the  long  and
  207. wee hours of the night, nights where I was more nearly to a coffein shock as to
  208. a regular night sleep. In times, where my consume of  coffee  gots  dimensions,
  209. which  where  not payable for me and hearings at University where not main goal
  210. of my life).
  211.  
  212. What I want to say with it: If you find a BUG in this program, Im really sour!
  213.  
  214. But Seriously: As I published this Version,  I  was  at  the  meaning  to  have
  215. reached  a  status  of BUGlessness, which makes it possible to do a publishing.
  216. (But, by the way, I was near a Coma and  a  physical  state  was  near  a  full
  217. seediness and prevented further work on it).
  218.  
  219. About information of mailfunctions I wouldn't be happy, but if they reach me, I
  220. will stop studying, plunder the next hypermarket (need some coffee), and code a
  221. BUGfree version.
  222.  
  223. Your Bugreports reach me via e-mail:
  224.  
  225.            wir94dgk@Rzaix340.rz.uni-leipzig.de
  226.  
  227. or via postal way:
  228.  
  229.            Michael Gollmick
  230.            Löbauer Straße 43
  231.            04347 Leipzig
  232.            Germany
  233.  
  234. Testconfigurations:
  235.  -AMIGA 1200, 2MB CHIP, 8MB FAST, Blizzard 1220 Turboboard, Kickstart 3.0
  236.  -AMIGA 1200, 2MB CHIP, 4MB FAST, Blizzard 1230II Turbboboard, Kickstart 3.0
  237.  -AMIGA 500+, 2MB CHIP, 2MB 16-BitFAST, Roktek HD-Controller, Kickstart 3.1
  238.  -AMIGA 500, 1MB CHIP, 1.5MB 16-BitFast, 4MB 32-BitFast, Neuroth 68020/882,
  239.   FSE-SCSI-Controller, Kickstart 3.1
  240.  -AMIGA 500, 512kB Chip, 512kB Fast, Kickstart 2.04
  241.  
  242. The future
  243. ----------
  244.  
  245. What I have planed for further version, what might be included
  246.  
  247.   - a GUI in higher resolutions (I've tried hard, but I couln't realize
  248.     until now)
  249.  
  250. I`m very thankful for suggestions  concerning  this  program  as  well  as  for
  251. further  projects.  Your  name  will be included in my credit list and you will
  252. recieve a free update (seems to be a little bit strange because this program is
  253. FREEWARE, doesn`t it?).
  254.  
  255. Credits
  256. -------
  257.  
  258. I`m very thankful to:
  259.  
  260.         Michael Reichenbach Oliver Steinhäuser and others
  261.          - for agonizing beta-testing
  262.          - as well as for ideas which are implemented in this
  263.            project or may be included in later versions
  264.  
  265.         Pascal Behrend
  266.          - for reworking the german manual
  267.          - for translating the manual into English (Have you ever read
  268.            my translation? No? - Seems to be the best!)
  269.  
  270.         Ville Ranki
  271.          - for the Finnish Guide
  272.  
  273.         Ron Shaw
  274.          - for spellchecking the english documentation
  275.  
  276.         Commodore
  277.          - for developing the best computer (todate) with a
  278.            tremedous Operating System.
  279.  
  280.         ...and all who mailed me
  281.  
  282. Credits
  283. -------
  284.  
  285. I`m very thankful to:
  286.  
  287.         Michael Reichenbach Oliver Steinhäuser and others
  288.          - for agonizing beta-testing
  289.          - as well as for ideas which are implemented in this
  290.            project or may be included in later versions
  291.  
  292.         Pascal Behrend
  293.          - for reworking the german manual
  294.          - for translating the manual into English (Have you ever read
  295.            my translation? No? - Seems to be the best!)
  296.  
  297.         Ville Ranki
  298.          - for the Finnish Guide
  299.  
  300.         Ron Shaw
  301.          - for spellchecking the english documentation
  302.  
  303.         Commodore
  304.          - for developing the best computer (todate) with a
  305.            tremedous Operating System.
  306.  
  307.         ...and all who mailed me
  308.  
  309. History
  310. -------
  311.  
  312. The story so far...
  313.  
  314. ... Version 0.10 - NOT OFFICIALLY RELEASED
  315.          - mouse-buttons are detected
  316. ... Version 0.20 - NOT OFFICIALLY RELEASED
  317.          - executeing a script when pressing the mouse-button
  318. ... Version 0.30 - NOT OFFICIALLY RELEASED
  319.          - program reacts on RMB
  320.          - executes a script
  321. ... Version 0.40 - NOT OFFICIALLY RELEASED
  322.          - The program is protected against some errors and gives an information
  323.          - Information-output, if not sent to NIL:
  324. ... Version 0.50 - FIRST OFFICIAL RELEASE
  325.          - Bootselector released (Aminet, see also Aminet CD 6)
  326.          - includet the Version-String for VERSION
  327. ... Version 0.60 - NOT OFFICIALLY RELEASED
  328.          - GUI implemented, mangels Erfahrung jedoch nicht
  329. ... Version 0.61 - NOT OFFICIALLY RELEASED
  330.          - Mousedetection improoved (more save detection)
  331. ... Version 0.62 - NOT OFFICIALLY RELEASED
  332.          - MMB is used now BUGfree for the first time
  333. ... Version 0.70 - NOT OFFICIALLY RELEASED
  334.          - Tooltype-detection (Script-directory and two Startup-
  335.            Sequencen have to be entered)
  336. ... Version 0.71 - NOT OFFICIALLY RELEASED
  337.          - bug fixed: machine doesn`t crash any longer when there are
  338.            no tooltypes -> defaults are set instead
  339. ... Version 0.72 - NOT OFFICIALLY RELEASED
  340.          - new Errorhandlingroutine
  341.          - detecting RMB makes problems
  342. ... Version 0.73 - NOT OFFICIALLY RELEASED
  343.          - detection of RMB is cancelled for now
  344.          - Source has been changed
  345.          - Errorhandlingroutine has been improoved
  346. ... Version 0.74 - NOT OFFICIALLY RELEASED
  347.          - Errorhandlingroutine is not BUGfree yet
  348.          - code optimized a little bit (gained 297 bytes)
  349. ... Version 0.75 - NOT OFFICIALLY RELEASED
  350.          - code optimized again (gained 1234 bytes)
  351. ... Version 0.80 - BETA-RELEASE of `BootSelector`
  352. ... Version 0.81 - NOT OFFICIALLY RELEASED
  353.          - bug fixed: machine crashed when a wrong directory was set
  354. ... Version 0.82 - NOT OFFICIALLY RELEASED
  355.          - a script is only executed when set in tooltypes
  356. ... Version 0.83 - NOT OFFICIALLY RELEASED
  357.          - checks now the Directory-Tooltype and adds a "/" if ":" or "/"
  358.            is missing
  359. ... Version 0.84 - NOT OFFICIALLY RELEASED
  360.          - if SCRIPTDIR isn`t set -> S: is default-directory
  361. ... Version 0.85 - NOT OFFICIALLY RELEASED
  362.          - if REGULAR isn`t set -> program is brought to an end
  363. ... Version 1.00 - CANCELLED IN LAST MOMENT, CAUSE OF A BUG
  364.                  - finished Documentation for the Release
  365. ... Version 1.01 - OFFICIAL AMINET RELEASE
  366.     07.08.95     - removed the ReadTooltype()-BUG
  367.          - Documentation has been overworked from Pascal and Tina
  368.          - making the .GUIDE
  369. -----------------> Had a very BAD hardcrash on my HD, so I had to stop the
  370.            developing for a while
  371.                  > restarted the developing on 19.08.1995 with an old 80Meg HardDrive
  372.  
  373. ... Version 1.10 - OFFICIAL AMINET RELEASE
  374.     30.08.95     - Code has been optimized again (gained 36 Bytes)
  375.                  - now up to tree times faster due to the optimization
  376.                  - REGULAR Tooltype may be edited short now
  377.                  - Errorhandler has been overworked again
  378.                  - needs less memory for its work
  379. -----------------> Developing stopped for some weeks due to some practical
  380.                    work and a fu..ing accident
  381.                  > development restarted on 3.10.95
  382.  
  383. ... Version 1.15 - NOT OFFICIALLY RELEASED
  384.     05.10.95     - addet the combination of LMB & MMB
  385.                  - REGULAR is no longer a required keyword
  386.                  - new keyword LMM for the combination
  387.                  - REGULAR has has a inline dafault now
  388.                  - created an Installer-Script (in German an English)
  389.                  - addet the Finnish Guide (thanks to Ville Ranki)
  390. ... Version 1.16 - NOT OFFICIALLY RELEASED
  391.     06.10.95     - addet the INFO keyword
  392. ... Version 1.20 - NOT OFFICIALLY RELEASED
  393.     07.10.95     - RMB is now detectable and includet
  394.                  - code has been optimized: pure code length is now 1878 bytes
  395. ... Version 1.21 - NOT OFFICIALLY RELEASED
  396.     08.10.95     - addet a small filecheck
  397.                  - optimized the code again due to new functions
  398.                  - inline speed has improoved a lot again
  399. ... Version 1.22 - NOT OFFICIALLY RELEASED
  400.     09.10.95     - a red screen will be opened, if required Startup-Sequence
  401.                    can't be found
  402. ... Version 1.23 - NOT OFFICIALLY RELEASED
  403.     10.10.95     - removed the OpenFile() bug, which causes an 'Object is in
  404.                    use'-Error if you tried to save or delete the executed
  405.                    Startup-Sequence
  406. ... Version 1.24 - OFFICIAL AMINET RELEASE
  407.     23.10.95     - fixed the Installer-Script
  408.                  - overworked the english DOC (thanks to Ron Shaw)
  409. Hope you can use this program. I would be happy about  any  reactions  to  this
  410. program.  If  you  use  it  or  if you have problems/questions, so feel free to
  411. contact me under:
  412.  
  413.            wir94dgk@rzaix340.rz.uni-leipzig.de
  414.  
  415. I will try to answer your questions within seven days if I can.  (In  the  last
  416. two  month  there where some problems getting acces to the net, so it took much
  417. longer than seven days. I want to excuse me for this in this way.)
  418.  
  419. Michael Gollmick
  420. in october 1995
  421.  
  422. --
  423.